home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / tbmod10.zip / TBMOD.DOC < prev    next >
Text File  |  1993-06-13  |  7KB  |  142 lines
  1.                          ┌─────────────────────────┐
  2.                          │ TextBar Mod version 1.0 │
  3.                          ├─────────────────────────┤
  4.                          │       written by        │
  5.                          │      Renier Crause      │
  6.                          ╘═════════════════════════╛
  7.  
  8. ┌─────────────────────────┐
  9. │ Introduction            │
  10. ╘═════════════════════════╛
  11.   This is a simple module player for DOS.  It plays all 4 channel Amiga
  12.   ProTrakcer modules through one of several sound output devices.  It
  13.   also displays 4 volume bars in shaded red, without leaving ANSI text
  14.   mode.
  15.  
  16. ┌─────────────────────────┐
  17. │ Requirements            │
  18. ╘═════════════════════════╛
  19.   This Module Player requires the following:
  20.     MS-DOS 3.x of higher
  21.     VGA adapter
  22.     286 or higher CPU
  23.   It is also recommended that you use some other sound device than the
  24.   PC's internal speaker.  The internal speaker REALLY doesn't sound too
  25.   good, but at least that isn't my fault, the internal speaker never
  26.   sounded too good.
  27.  
  28. ┌─────────────────────────┐
  29. │ Sound Devices supported │
  30. ╘═════════════════════════╛
  31.   This simply amazing ;-) little player uses GoldPlay, which of course is
  32.   coded my Sourcer from CodeBlaster (his real name seems to be Stein
  33.   Norheim).  I want to thank the CodeBlasters for giving us mortal
  34.   programmers the ability to program such cool programs as this one.
  35.   This incredible unit supports the following sound devices:
  36.      1.  Soundplayer/Covox in LPT1  (Mono)
  37.      2.  Soundplayer/Covox in LPT2  (Mono)
  38.      3.  SoundBlaster               (Mono)
  39.      4.  Internal Speaker           (Mono of course)
  40.      5.  Two Soundplayers LPT1+2    (Stereo)
  41.      6.  SoundBlaster Pro           (Stereo)
  42.      7.  Stereo SoundPlayer in LPT1 (Stereo)
  43.      8.  Stereo SoundPlayer in LPT2 (Stereo)
  44.  
  45. ┌─────────────────────────┐
  46. │ Command line options    │
  47. ╘═════════════════════════╛
  48.   All settings, for the player, are sent through the command line.  If
  49.   you want to set some settings permanent, I would advise you to create
  50.   a batch file containing the options you want to use.  I may someday
  51.   write a config file, if somebody out there wants it, but I think it's
  52.   just a wast of good time.  Please remember that the file GOLDPLAY.OVL
  53.   must be in the same directory as TBMOD.EXE.  This is basically the
  54.   format of my command line (actually it's about all programs command
  55.   line format):
  56.     Usage:  TBMOD [options] modname[.MOD]
  57.   The not so mysterious modname mentioned above, can conatin wildcards,
  58.   but TBMOD will only play the first module that matches the wildcard.
  59.   If no extension is given .MOD will be assumed.  This is all so simple
  60.   really.
  61.   Now here comes a brief explanation of this options part I mentioned:
  62.     /D#      sound device       (3)
  63.     /F#####  mixing frequency   (16000)
  64.     /I#      SoundBlaster IRQ   (7)
  65.     /M#      SoundBlaster DMA   (1)
  66.     /P###    SoundBlaster port  ($220)
  67.     /S       show SB settings
  68.   The # signs represents numbers.  All numbers are treated as decimal,
  69.   if you want to enter hexadecimal number, you should prefix them with
  70.   a $ sign, for example /P$220 would set the SoundBlaster output port
  71.   to 0220h.  The numbers in parenthesis above are the default values
  72.   that are asumed, if you don't specify that specific option.  The /S
  73.   option is there for you to test everything is exactly setup as you
  74.   want it.
  75.  
  76. ┌─────────────────────────┐
  77. │ The Keys                │
  78. ╘═════════════════════════╛
  79.   Here follows all the incredible keys you can press while the music
  80.   is playing:
  81.     ESC - stop playing and return to DOS
  82.   Well, maybe the keys are not all that incredible as they first seemed.
  83.  
  84. ┌─────────────────────────┐
  85. │ Technical Information   │
  86. ╘═════════════════════════╛
  87.   This crazy program was coded in Turbo Pascal 7.0 (probably the coolest
  88.   language ever written).  It also has BASM statments included (that's
  89.   inline assembly to you).  You didn't think I programmed the PEL registers
  90.   from Pascal, did you?  The source code of this program isn't available
  91.   for you inquisitive public out there, and if you think you can bribe
  92.   me with money, you are RIGHT!  There is nothing on this earth that
  93.   can't be bought, so if I happen to recieve an envelope that contains
  94.   some money, the sender might just happen to recieve some source.  Be
  95.   warned though if you want well documented source code you would have to
  96.   send more money, because I would have to document it especially for you.
  97.   Please contact me through eMail (address at end of document) before
  98.   sending me money.  That is if you want source code, if you just want to
  99.   send me money, hey go ahead, I won't stop you!
  100.  
  101. ┌─────────────────────────┐
  102. │ Copyright               │
  103. ╘═════════════════════════╛
  104.   TBMOD 1.0  (C) 1993 RC-SOFT, written by Renier Crause.
  105.   This program is copyrighted by me, Renier Crause.  That doesn't mean
  106.   you shouldn't copy this program, in fact I order you to give this
  107.   program te every living person you know (it would of course help, if
  108.   the person you give it, owns a PC).  No, this copyright means you may
  109.   not change my program, or dissemble it without my permission.  This
  110.   program is NOT freeware, it is what I call Mailware (nice name, eh?)
  111.   What this Mailware actually means, is that if you like this program
  112.   (or not) you are obliged to let me know, either through eMail or
  113.   snail mail.
  114.  
  115. ┌─────────────────────────┐
  116. │ How to contact me       │
  117. ╘═════════════════════════╛
  118.   I would prefer you to contact me through eMail.  My internet address
  119.   is:
  120.       9147659@rkw-lan.cs.up.ac.za
  121.       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  122.   Yes you read correctly I'm from South-Africa, and we can actually program
  123.   here (well some of us anyway).  If you don't have access to eMail (shame
  124.   on you) you can also reach me at:
  125.       R.G. Crause
  126.       P.O. Box 38141
  127.       Garsfontein X10
  128.       0042 PRETORIA
  129.       Republic of South-Africa
  130.   PLEASE contact me if you have any comments, suggestions, wish lists,
  131.   bug reports, hate mail etc.  I'll answer all meaningfull eMail, and
  132.   even some meaningless ones.  Sorry I can't answer any snail mail
  133.   comments, but I can sure act on any suggestions you mailed to me.
  134.   Remember, this is not freeware, you are obliged to send me your
  135.   comments :-)  Hey I'm not really that serious, but I would REALLY
  136.   like to hear from you.
  137.  
  138.   Renier.   (written on 12 June 1993)
  139.  
  140.   Oh yeah!  That's the end of this stupid document!!      ,,,,,
  141.                                                           (o o)
  142. ------------------------------------------------------ooO--(_)--Ooo--------